package com.example.chamberlainserver.mapper;

import com.example.chamberlainserver.Entry.DormTrippingRecord;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 宿舍跳闸记录数据访问接口
 */
@Mapper
public interface DormTrippingRecordMapper {
    
    /**
     * 添加跳闸记录
     * @param record 跳闸记录信息
     * @return 影响行数
     */
    int insertRecord(DormTrippingRecord record);
    
    /**
     * 更新跳闸记录
     * @param record 跳闸记录信息
     * @return 影响行数
     */
    int updateRecord(DormTrippingRecord record);
    
    /**
     * 根据ID删除跳闸记录
     * @param id 记录ID
     * @return 影响行数
     */
    int deleteRecord(@Param("id") Integer id);
    
    /**
     * 根据ID查询跳闸记录
     * @param id 记录ID
     * @return 跳闸记录信息
     */
    DormTrippingRecord getRecordById(@Param("id") Integer id);
    
    /**
     * 获取所有跳闸记录
     * @return 跳闸记录列表
     */
    List<DormTrippingRecord> getAllRecords();
    
    /**
     * 根据宿舍号查询跳闸记录
     * @param dormitoryNum 宿舍号
     * @return 跳闸记录列表
     */
    List<DormTrippingRecord> getRecordsByDormitoryNum(@Param("dormitoryNum") String dormitoryNum);
    
    /**
     * 根据班级名称查询跳闸记录
     * @param className 班级名称
     * @return 跳闸记录列表
     */
    List<DormTrippingRecord> getRecordsByClassName(@Param("className") String className);
    
    /**
     * 根据辅导员姓名查询跳闸记录
     * @param counselor 辅导员姓名
     * @return 跳闸记录列表
     */
    List<DormTrippingRecord> getRecordsByCounselor(@Param("counselor") String counselor);
    
    /**
     * 根据处理状态查询跳闸记录
     * @param isHandled 处理状态
     * @return 跳闸记录列表
     */
    List<DormTrippingRecord> getRecordsByHandleStatus(@Param("isHandled") Boolean isHandled);
    
    /**
     * 分页查询跳闸记录列表
     * @param params 查询参数
     * @return 跳闸记录列表
     */
    List<DormTrippingRecord> getPagedRecordList(Map<String, Object> params);
    
    /**
     * 获取分页查询的总记录数
     * @param params 查询参数
     * @return 总记录数
     */
    Long getPagedRecordCount(Map<String, Object> params);
}